l... i r i ts A Tec h n i c a .1 R o •fetr & n c & 
Manual 

Sept. 9, 1985 


ATARI corp. confidential 
S ept » 9, 1985 




LINE A ••DOCUMENT 
TABLE OF' CONTENTS 


Ini t. i al :i. zati an 

Put pixel, 

Set pixel,,,,,,,,. 

Line 

Horizontal line 

Fi 1 1 ed rec tang 1 e. . 
L i n e -•• b y - 1 i n e -f : i 1 1 e d polygon 

Bi t.Bl t . . 

Text Bit 

Show mouse. . 

Hi de mouse. 



Transform mouse. 

Undraw sprite. 

Draw sprite 

Copy raster form 

Seedf ill. (exists only in versions of TDS after the 
1st release) 

( 0 ) I n i t i a 1 i z at i on 

( 1 ) Put pixel 

“ *“***'"««•■»»«..« KUUtlMMn 

(2) Bet [31X0].., 

( 3 ) Li ne « . . „ „ K „ „ n , „ H , „ , „ M B „ „ „ „ . „ 

(4) Hor i Eontal ' i i ne. , „ . n „ w 

^ FF - 1 1 rectangle. 

^ Line by -line filled polygon. ........ 

( 7 ) B i t B 1 1 u ....... 




1 


1 

1 

1 

1 

i 

i 

l 

l 

1 

i 

l 

l 

3 . 


4 

4 


o 


A T A E I C □ R P „ C 0 N F : ' I D E M T I A L 
Sept. 9 ? 198 S 




err bl.t parameter block offsets 6 


I. PARAMETER BLOCK 7 

II. MEMORY FORMS 8 

III. RASTER OPERATIONS 9 

IV. PATTERNS. 9 

V. BAB '0 TRICKS 10 

<8> Text Bit 12 

(9) Show mouse 13 

(10) Hide mouse 13 

(11) Transform mouse. . . 13 

(12) Undraw sprite. . 13 

( 1 3 ) Draw spr i te . „ 14 

(14) Copy raster -form. 15 

USING THE LINE "A" INTERFACE 15 

The LINE"A" input variables structure: 15 


ATARI CORP. CONFIDENTIAL 
Sept. 9, 1985 


77a 


THE LONG AWAITED LINE 


DOCUMENT 


I n a r d e r t o p r a v i cl e 1 1 q a i c k a n d d i r t y ! ’ a c: c e s <s t o t h a 

a & s b m b 1 tv? r - 1 e v e J. g r a p h i c: s r a u t i n e «; , A T A E I e n g i n e © r s h a v a s © t u p t h e 
600 00 s LIME "A" exception as an interface to several useful 
r o u t i n e s .. \ h e L. .1. N E "A 1 1 i n t e r f a c a :i. s f a s t e r t h a n g o i n g t h r o u g h 

G E M ' s V D I a n d h a s s □ m e e x t r a f e a t u r e s * A 1 s o , L I M E “A" c: a 1 1 s " 
r e q u i r e 1 e s s a p p ]. i c a t', i o n c o d © t h a n t h e :L r V D I c a u n t e r p a r t s » D f 
c o u r h e , L .1 NE *' A 1 ' d o e s n ' t r e p lac e the V D 3! c o m p 1 e t e 1 y , b u t: i f a n 
a p p 1 i c a t i o n o n 1 y n e © d s a f e w p r i /n i 1: i v e g r a p h i c s f u n c t i o n s ( a n d 
wants maximum performance) , then LINE "A 11 is sufficient (and 
opt i mail. ) „ 

The L. I N E " A 11 i n t: e r *f a c: e i s p r o v i d a d f a r t h e h a c k © r a t -*• h a a r t 

and no claims are made about its ease of use* The interface may 

s b e m u n u u a 1 1 y i n c o n s i s t e n t , b u t i t was n o t c:l e s i g n e c.1 ; j. t & ;L m p 1 y 
f e 1 1 o u t a s a f r e e I:. 1 ) i e f r o m t h e 3, o w -- ]. a v a 1 VD 1 p r i m i t i v e s i n t a r f a e e * 
T‘ h a t i s ? t h e s a r o u t i n e s a r " e t h e h e a r t o f t h e V D I » 

The LINE “A" interface consists of 15 opcodes* The calls to 

LIME "A" are assembled as 1 word instructions, the highest 4 bits 

of which are 1010 (A in hexadecimal, hence LINE ,l A n ) and the lower 
1 2 b i t s o f w h i c h a r e u s e d a s t he opcode field- F o 1 1 o w i n g i s a 

d e s c r i p t i o n o f t h e 1 5 o p c o d e s s 

0 - I n i 1 1 a lie at i on „ 

1 Put pixel „ 

2 - Set pixel,, 
s::; Line. 

4 Horizontal line,, 

5 k F i 1 1 e d r e c: t a n g 1 © H 

6 - L i n e b y - 1 i n © f i 1 ]. © cl p o 1 y g o n „ 

7 * Bit HUt. 

8 =» Text Bit. 

9 - Show mouse* 

10 = Hide mouse « 

1 1 T r a n s f o r m m o u s e * 

12 •»- Undraw sprite* 

13 - Draw sprite., 

14 Copy raster form. 

15 <* Seed-fill, (exists only in versions o-f TOS after the 

1st release! 

Che LINE- "A" routines have some features that the VDI doesn't 
support.. Bit Hi It supports hal -f --tone patterns on the source and 
I ext Bit supports all 16 Bit Bit logic operations, not. just the 4 
GE~M VDI writing modes. In addition to these strai ght-f orward 
extensions LINE::. "A" also allows the adventurous programmer to 
experiment with special effects. The BitBlt is especially 
g e n e r o u s i n t h :i. s a r e a „ 


(0) In i t i al. i sat i on 
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; I nit the LINE! "A 


dc . w $ A 0 0 0 


i nput ;i 

n one- 



output 3 

dO ptr 

t a t ft b b a s e a d d r e <•;> s o f L; I N E ‘ ' 

A M i n ter face 



var i ab 3. es - 


aO 

- ptr to 

t h e b a s e a d cJ r- e s s o f L.. I N E " A " 

i nt er f ace 



var i ab 1 es .. 


a 1 

- ptr to 

a r r a y cj t p t: r s t o t h e 3 y s t e m 

■font headers. 

a 2 

p t r t o 

a r r' a y o f p t r" s t o t h e 1 5 L 1 N IE 

"A" routi nes. 


n o t e T h e v a l u e r e t u r n e d i n a 0 i s t h e s i n e q u a n a n 
of the LINE "A" inter -face. Inputs to all the 
o t h e r L I N E "A" a p e r a t i o n s a r e m a d e r e 1 at :i. ve 
t o t h i s v a 1 u e , i - e . , t h e L I N E ‘ 1 A 1 ' in t e r f a c e 
v a r i a b 1 e s a r e c: o n t a i n e d i n a s t r u c t u r e p o i n t e d 
t o b y a 0 . T h e a f $ s e t s a f t h e s e v a r i a b I e s i n 
t h e s t r u c: t u r e a r e g i v e n b e 1 o w H 

b u g s s I n t h e. f i r s t T’ G S r e 1 e a s e , a2 i s n o t r e t u r n e d 

a s d e s c: r i b e d a b o v e - I n <*!> t e a d , i t i s p r e s e r v e d 
across the LINE "A" call- 

See Example Program #2 at the end of this 
d o o u m e n t f o r t ft e t e e h n i q u e t h a t. m a k e s a 2 p a i n t 
t c:) t h e p r o p e r p 1 a c e « 

(1) Put pixel 


dc „ w t ADO 1 


P 1 o t a p i x e I a t x,y. 


i n p u t a I N T I N Z 0 ] » p i x e 3. v a 3. u e - 

P T B I N Z 0 ] !=:: x c cj o r c:l i n a t e - 

F* T S I N C :L H = y c c j o r c3 i n a t e « 

output 3 none - 

notes For a discussion of the CGNTRL. , INTIN, PTSIN, 

INTGUT, & PTBGLJT arrays, see the GEM VDI 
manual « 
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(2) Get pixel 


dc.w $A002 


i nput : 


output: dO 


; Get the pixel at x,y. 


PTSINC03 » x coordinate. 
H f S I N C % "J * y c a or d i n a t e , 

~ pixel value. 


( 3 ) L .i n e 


dc.w TAG 03 


5 Draw a line between (xl,y:L) and 
<x2,y2). 


i nput s 

XI « Xl 

coordinate 


Y 1 == y 1 

coordinate 


Y o — , , o 

A a... 

coordi riate 


Y2 - y'2 

coordinate 


COL.BITO « bit value for plane 0. 

COLB! 7' 1 «* bit value for plane 1. 

CO LB 1 1 2 — bit value for plane 2. 

L0LB1T3 -- bit value for plane 3. 

LNMASK line style mask. 

WMODE ■■■■■ writing mode. 

L-STLIN ™ always set this to -1, if using 
xor mode else ignore it. 


output : 


LNMASK is rotated to align with right-most 
endpoint. 


1) If the line is horizontal , LNMASK is a 

word-aligned pattern, not a line style. That 
is, a bit other than bit 15 of LNMASK may be 
u s e d a t t he left most endpoint. 

2 ) As the foregoing references imply, the line 
is always drawn from left to right, not from 

( X .1. , Y 1 ) to (X2,Y2). ihus, LNMASK is always 
applied from left to right. 

Because of the quirks, an application cannot 
depend upon the phase of the LNMASK being 
proper i y updated between calls to line-drawing 
primitives. If the phase is critical, the 
a p pi i c a t i o n mu s t c ompute and i n i t L. N M A S K 
before each line is drawn. 


Line A Document PAGE 3 ATARI CORP. CONFIDENTIAL 


773 



L N 11 A S K i a a p p 1 i e d t o t h a 1 i n e d r a w i n g D D A 

a I g a r i t. h m a I o n g the dir e c t i o n o f grea t. e r 
delta. If delta Y is greater than delta X, 
then LNMASK is applied in the Y direction. 

T h e se 1 i n e d r a w i n g quirk s a n d n a t. e s apply t o 
the OEM VDI, too." 


( 4 ) H a r i o n t a 1 1 :i. n e 


dc.w TACO 4 


inputs XI = x 1 

Y1 - yl 

)( *'? tr.: v ^ 

COLB I TO 

C0LB1T1 

C0LBIT2 

C0LBIT3 

WMODE 

PATPTR. 

PATMSK 

MFIL.L 


outputs none. 


; Draw a line -from (xl,yl) to 
( x 2 , y 1 ) . 

coordinate, 
coordinate, 
coord i nate. 


- b i t 

val ue for 

pi ane 

0 

- b i t 

val ue f or 

pi ane 

1 

- b i t 

val ue far 

p 1 ane 


- b i t 

val ue for 

pi ane 

3 


- writing mode. 

-- ptr to the fill pattern. 

- p a 1 1 e r n i n d e x . 

~ multi -plane pattern flag. 


(5) Filled rectangle 


dc.w t-AOOS 


; Draw a filled rectangle with upper left 
; corner at (xl,yl) and lower right corner at 


,y2) 


i nput. s 


XI = xl 
Yl - yl 

X n . . f~\ 

Y2 - y2 
CD LB 1 TO 
COLB I T 1 
CD LB I 12 
CO LB IT 3 
WMODE 
PATPTR 
PATMSK 
MF I LL 
CL I F :; ‘ 

XM INCL 


coordi nate. 
coor d i nate. 
c oordi nate. 
coordinate. 

bit va 1 ue f or plane 0 . 
b i t val ue for plane 1 . 
b it v a 1 u e f a r p 1 a n e 2 . 
bit val u e f o r p ]. a n e 3 . 
wri t i ng mode. 

83 ptr to the fill pattern . 

= f ill p a 1 1 er n i n d ex . 

= mul t i-pl ane -fill pattern f 1 ag . 
5 = c 3. i ppi ng f 1 ag . 

- x m i n i m u m f o r c 1 i p p i n g . 
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XMAXCL 
YM I NCI... 
YMAXCL 

:,;r V 

5=8 y 

max i mum 
mi ni mum 
max i mum 

for cl lipping 
■for cl i ppii. ng 
for cl ipping 

output : 

n on e . 





*■ ^ ) L ine b y I i n e filled polygon. 


dc,w $A006 ; Draw 1 sc: an -line of a filled polygon. 


i nput s 


PIBINC3 - array a f polygon vertices. 

( ( x 1 , y 1 ) , ( x 2 , y2 > . . . , ( x ri , yn ) , ( x 1 , y 1 ) ) 
CONTRL C 1 II — n — number of vertices. 

Y 1 -= y coordinate of scan-line to fill. 


COLB I TO 

C0LBIT1 

C0LBIT2 

C0LBIT3 

WMGDE 

PATPTR 

PATMSK 

MFILL 

CLIP a 

XMINCL 

XMAXCL 

YMINCL 

YMAXCL 


- bit value for plane 0. 

- bit value for plane 1. 

" bit value for plane 2. 

~ bit value for plane 3. 

- writing mode. 

” ptr to the fill pattern. 

- fill pattern mask. 

“ multi -plane fill pattern 
clipping flag. 

- :< minimum for clipping. 

- maximum for clipping. 

: = y minimum for clipping. 

- y max i mum for clipping. 


f 1 ag . 


output : 


XI and X2 are clobbered. 


note: 


The 1st endpoint must be repeated at the end 
of the list of n endpoints., 


(7) BitBlt 


dc.w TA007 ; Perform a BIT BLock Transfer. 


input: a 6 — ptr to a structure of input parameters, 

output: none. 
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BIT BLT 

PARAMETER 

BLOCK OFFSETS 

B WD 

equ 

+00 

; w i d t h o f to 1 o c k i n p i x e 1 s 

B_HT 

eq u 

+02 

5 heigh t o f to 1 o c k in pi x e 1 s 

PLANE...C 

T eq u 

-i- 04 

ji number of consecutive planes to 
bit CD} 

FG....COL 

eq u 

+06 

; foreground color (logic op 
index chi bit) CD} 

BG....COL 

eq u 

+08 

5 background color (logic op 
index; lo bit) CD} 

OP.,.. TAB 

eq u 

+ 10 

5 logic ops for all fore and 
background combos 

S_XMIN 

equ 

+ 14 

; minimum Xs source 

S....YM I N 

equ 

+ 1 6 

; m i n i m urn Y a s a u rce 

S....FORM 

equ 

+ 18 

; source form base address 

S....NXWD 

equ 

4< *'? *7 

1 j-. Xh 

; offset to next word in line (in 
bytes) 

S„.NXLN 

eq u 

+24 

5 off set t o n ex t line in plane ( i n 
bytes ) 

S.JMXPL 

equ 

+26 

; offset to next plane from start of 
current plane 

D XNIN 

eq u 

+28 

; minimum X: destination 

D YMIN 

eq u 

+30 

ji minimum Ys destination 

D FORM 

eq u 

+32 

; destination form base address 

D_..NX WD 

equ 

+36 

5 offset to next word in line (in 
bytes) 

D....NXLN 

equ 

+38 

; offset to next line in plane (in 
bytes) 

DJMXPL 

equ 

+40 

; offset to next plane from start of 
current plane 

P...ADDR 

equ 

+42 

; address of pattern buffer (0s no 

pattern) CD} 

P...NXLN 

eq u 

+46 

5 offset to next line in pattern 
(in bytes) 

P....MXPL 

equ 

+48 

ji offset to next plane in pattern 
(in bytes) 

P...MASK 

equ 

+50 

; pattern index mask 

P_BL.OCK_ 

.LEMeq u 

76 

; the parameter block must be 76 
bytes long 

■#** notes 



parameters marked 

with CD3- 

may be altered during the course of 

the BIT 

BLT ex ecru ti on 
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contents of OP TAB 


+00 byte 


+01 byte 


+02 byte 


+03 byte 


logic operation employed when foreground and 
background color bits for current plane are 
both clear (0) 

logic: operation employed when current plane's 
•foreground color bit is clear (0) and 
background color bit is set (1) 

logic operation employed when current plane's 
foreground color bit is set (1) and background 
color bit is clear (0) 

logic operation employed when foreground and 
background color bits for current plane are 
both set (1) 


0 . 


PREFACE 


Before one floggles one's tormented mind with this tangled 
nest of arcane knowledge, one ought to be intimately familiar 
with chapter 6 of the GEM VDI manual, the author assumes that 
one s knowledge of Raster matters is quite wide and that the 
rudiments of BIT EiLTING are below discussion. If the author 
is mistaken then he's sorry (and you're about to become lost 
in the sea of woe, oh ho!). 


I. 


PARAMETER BLOCK 


The BIT BL T is accessed via a 76 byte parameter block. 
Register A6 points to the head of this block upon LINE A 
entry Gn].y the first 52 bytes of the block need be attended 
to by the abuser. The remaining space is maintained 
internally by the BIT . Note that in the following 
e:< p 1 anat i ons , parameters will be referred to by their 
symbolic offsets into the parameter block. 
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II. 


MEMORY FORMS 


Memory -forms are something like a cabbage patch, (a cabbage 
patch is a place for mentally retarded programmers) , let's face 
it, forms are nothing like a cabbage patch, if you think they are, 
go back and read chapter 6 in the GEM VDI manual, if you know 
anything at all about memory forms, you know they are almost 
entirely but not totally unlike a garbage can. one difference is 
that memory forms are of two sexes, source and destination, 
each sex is defined by the same four parameters: form block 
address, form block width, offset to next contiguous word, and 
offset to next, plane. 

S_..FORM and D__FORM point to the first, words of the source 
memory form and destination memory forms, respect i vel y . these 
addresses must, fall on word boundaries or severe hardships will 
fall (as will address exceptions) like plagues upon the ancient 
egypti aris. 


S„,NXWD and D._NXWD are offsets to the next word in a plane of 
the memory form, for example, in the monochrome mode the value is 
2 while a value of 4 is used in medium resolution and 8 is 
applicable to low resolution. 

S_..NXLN and D_NXLN are form widths for source and destination. 

( i can't remember which one belongs to the source form and which 
one belongs to the destination form). These widths must be even 
byte values, as you know, for they represent the offset from one 
row of the form to the next and forms must be word aligned and an 
integral number of words wide. (hint: the hi res screen value is 
90 while lo and medium rez values are 160) 

S._NXPL and D„NXPL are offsets from the start of one plane to 
the start of the next plane, because of the ST screen's 
interleaved plane structure, this value is always two (2). 
alternative universes allow for a series of contiguous planes 
where NXPL values are the number of bytes in each plane, thus , it 
is possible to BLT from the contiguous universe into the 
interleaved ST universe and vice versa. 


the actual bit aligned blocks of memory are defined within 
the form by an upper left anchor point, a pixel width, and a pixel 
height: (S„XMIN, S„YMIN, B...WD, and B„.HT) . the location in the 
destination form is defined by an anchor point (D„XMIN, D_YMIN) . 
no harm will come if these two areas overlap. Note that no 
clipping is performed and there is no checking to determine 
whether the bit. blocks fall within the confines of the 
encompassing memory forms, finally, the number of planes to be 
transferred (the number of iterations of the BLT algorithm) is 
contained in the PLANE_CT word. 
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Ill- RASTER OPERATIONS 


JAB i s a table of four RASTER OP codes- El a eh of the byte 

wide entries in OP TAB contain a code for one o-f the sixteen 

1 o g i o a 1 o p a r a t i a n s b a 1 w a e n c o n s e n t i n g s o u r a e a n cl d e s t i n a t i o n 
b 1 a c k s * F- o r e a c: I": p 1 a n e , t In e I a y :L c a I a p e r a t ;L o n i s c h o s a n b y 

\ r | c: * ^ K n y * n ° t be □ I T A B with a vain b d a r i v a d f r o m F' 0 C □ L a n d 

BO_CQL words- For a given plane "r. " , bit M n 11 of FG..COL is the hi 
bit of the two bit index value and bit 11 n ir of BB COL is the lo bit 
o-f the index value. 


f or” 


those with a furniture fetish, here is a tables 
t 0 ( n ) B 8 ( n ) 0 p T A Fi< e n t: r y 


0 0 

0 1 

1 0 

l i 


f i rst entry 
second entry 
third entry 
f ourth entry 


IV. PATTERNS 

F 1 ' a 1 t: e r n s a r e w a r d w i d e , wo r d a 1 i g r i e cl images t h a t a r e 
1 og i c a 1 1 y and ed wit: h t h e sour c: e p r i or t o t he logical c omb i n a t i on 
o f s o u r c e w 1 1 h c:l e s t i n a t i o n . „ 

P a 1 1 e r n s a r e p a c k e d i n a n i m a g i n a r y grid a n c h o r e d a t t h e 

upper left corner (0,0) of the destination memory form. 

P a 1 1 e r i”) s a r e :i 6 to i t s wide a n d r e p © a t © d e very 1 6 p i x e 1 s 

hor i Eontal 1 y „ 


F a 1.. ter n s a r e a n i n t e g r a 1 p o w e r o f 2 i n ft e i g hi t. an d r e p e a t 
v e r t i c a 1 1 y a t t h a t f r e q u e n c y „ 

The source is shifted into alignment: with the destination 
r ec t a n g 1 e p r i o r t o t In e c o m d x n a t i a n of source with pattern » Thus, 
t h e r e 1 a t i o n s h i p b e t w e a n s o u r c e and r 3 a t 1 e r n is dependent up a n t h e 
X,Y positioning of the destination rectangle. 

p AD DR points to the first word of the pattern. If this 

p a i n t: e r is 0 , a p a t: t e r n is n a t c o rn b i n ed with the s a u r c e 
rectangl e« 

I ^ N X [... M i s t h e u f f s e t ( i n b y t: e s ) b e t w e e n c cd n s e c u t i v e w o r ci s i n 
t hi e p a 1 1 e r ‘ n - F a r r e a s a n s t a a in a n e to go into here, t h i s n u rn b e r 
s in o u 1 d b e a n i n t e g r a 1 p o w e r o -f 2 ( s u c h a s 2,4, or” 8 ) 


97 9 


i n e 
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P....NXPL. is the offset (in bytes) from the beginning of a plane 
to the beginning of the next plane. In the case of a single plane 
pattern used in a multi -plane environment, this value would be 
aero, thus, the same pattern is repeated through all planes. 

P .... M A S K w o r k s w .i t ft P _ N X L N to specify t ft e 1 e n g t. h of t h e 
pattern. The length (in words) of the pattern must be an integral 
power of 2. 

if P....NXLN - 2 *•* n 

then P.,.,MASI< = (length in words ••••1) << n 

... i don't know why. go ask your father. 


V. BAG '0 TRICKS 


Q. I want to BL.T from a single plane source to multi -plane 
destination. 

A. That's not in the form of a question. And besides, i can't 
think with that water pick spurtin in my ear. Hey, that's my cat 
your putt in in the Cuisinart. Wha the fuh you think your doin 
bustin into my word processor like this. Hey bud, stay a way from 
that delete key. Hey moe foe, i 'm serious. How'd you like an 
unexpected interrupt ? 

Q. This key is loaded and it's pointed at. your bonus check. 

A . ok , ok . . . i'll talk. 

S„NXPL. =0 ~> the same source plane is BLTED to all 

dest. i nat i on p 1 anes 


Q. yea, i know that but what logic ops do i use '? 


A. to map 1's to -foreground color and 0's to background color- 


set 0P..TAB ton 


1 oad 

into BG....C0L 


of f set 

1 ogle op 


+00 

00 

al 1 

+0 1 

04 

D' 

+02 

07 

D' 

+03 

15 

all 

egr ound 

color into F0_COL 

and 


zeros 

<- Cnot S3 and D 
< - S or D 
ones 

background color 
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U« you wanna buy some lake bottom property? 


to map 1 b to f< 

•ar ©ground a 

:) 1 or 

an d 

make 

0 ' «> t 

set OP TAB to: 






of f set 

1 ogle: op 





+00 

04 



D ' < 

[not 

+0 1 

04 



D J < 

Criot 

+02 

07 



D ' < 

- S or 

+03 

07 



D' < 

■“ S or 

load f a r a gro u n d 

col or i nto 

FG_ 

COL 



it: doesn't matter what, you 

p ut 

i nto 

BG 

COL 

don't forget to 

set: S_NXPL 

to 

0 




enough Smalltalk, let's get down to the core of the issue- 
Here are some of my Aunt Marge's flavorful BIT BLT recipes! 


1 . BLT a pattern without Source to the Destination. 

For this number, we'll need a word of ones. Label it "ones:" 
ne:<t, point S_FORM at "ones". Set S._NXLN, S...NXPL, S..NXWD, 
and S_YMIN.to 0. Bet up the pattern as you usually 
would and before you know it, you'll have a wonderful 
steaming pattern filled rectangle. 


2. this is a nice way to make a sprite like device. 

o you will need to bake? a monoplane mask, everywhere there 
is a 1 in the mask, the background will be removed, 
wherever a 0 falls, the background is left intact. 
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1 og i c op 


set OP_TAB to: 
offset 


+00 


04 

D ' 

< Knot 

s:j 

and 

D 

+01 


04 

D ' 

< [not 

si 

an d 

D 

+02 


07 

D ' 

<- S or 

D 



+03 


07 

D' 

< S or 

D 



load f or eg r oun d 

color i 

. nto 

FG..C0L 





it doesn't matte 

r what 

you 

put into B6 

_C0L 





next, take? a monoplane form (or multi —plane form) and 
"or" it (QP 07 ) into the area that you just scooped out 
with the mask feeds a family of four. 


<8) Text Bit 


dc..w ' 1 -AU 08 ; Perform a TEXT BLock Transfer of 1 

character. 


i nput : 

WMODE 


I c, a I r u 

TEXTBG 

FBASE 

FWIDTH 

SOURCE X 

SOURCEY 

DESTX 

DESTY 

DEL.X 

DEL.Y 

STYLE 

LITEMASK 

SKEWMASK 

WEISHT 

ROFF 


LOFF 


SCALE 

XDDA 

DBA INC 

SCALD I R 

CHUP 

MONO 

SCRTCHP 


“ writing mode. ( 0-3 -> VDI modes 

4-19 — > BitBlt modes) 
ss text foreground color. 

-■ text background color, (used for modes 4 - 19 ) 

- ptr to gtart of font data, (font form) 

- width of font form. 

x coord of character in font form. 

~ Y coord of character in font form. 

- x coord of character on screen. 

~ y coord of character on screen. 

- width of character. 

- height of character. 

- vector of TextBlt special effects flags. 

~ the mask to use in lightening text. 

:s! the mask to use in skewing text. 

- the width by which to thicken text. 

" offset above character baseline when 
skewi ng . 

“ offset below character baseline when 
skewing. 

~ scaling flag. (0 =*> no scaling.) 

~ accumulator for x dda. 

~ fractional amount to scale up or down. 

- scale direction flag. (0 ~> down) 

- character rotation vector. 

- monospaced font flag. 

=: "" ptr to start of text special effects buffer. 
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SCRPT2 


offset of scaling buffer in above buffer. 


output ! none. 


(9) Show mouse 

dc.w TA009 Shaw the mouse, 

inputs see GEM VDI manual, 
outputs none. 

(10) Hide? mouse 

■ II *1 » » K 

cl c . w $■ A 0 0 A ; H i d & t. h e m o u s © „ 

* n u ** m 

inputs see GEM VDI manual. 


outputs none. 


(11) Transform mouse 

dc.w TA00B ; Transform the mouse's form, 

M M M U H H 

i n p u t s see 8 E M VDI m a n u a 1 . 


output s n one * 


(12) Undraw sprite 


de-w $A00C ; Undraw the previously drawn sprite. 


1 nput s a2 -- ptr to spr it.© save b 1 oc k . 

notes The sprite save block is used to save the screen 
underneath the sprite. Its size is 10 bytes + 64 bytes 
per plane, i.e. (10 ■+■ VPL.ANES * 64) bytes. 

o u t p u t s c 1 a b b e r s a 6 . ("C" pr o g r a m m e r s b e ware. ) 
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( 1 3 ) 


Draw spri t e 


t;l c:: . w # A 0 (3 1!) ii D r aw a & p r i t e * 


i n p u t s d 0 - x hi o t s p a t « 

di - y hot spot. 

a 0 p t r t o s p r i t e c:l e *f i n i t i o n bloc k . 
a 2 ::::: p t r t a s p r i t e s a ve bloc k « 

SPRITE DEFINITION BLOCK LAYOUT 

d S « W 1 X offs 0 1 O f l”1 Q t S p CD t - 

c:l s - w 1 y o f f s e t o f h a t s p o t „ 

d s . w 1 f o r m a t flag. (1 - > V D I F a r mat, 

■I «> XOR Format) 

'VDI Farfnat: 

f g b i t b g b i t a c t i a n 

0 0 transparent to 

screen 

0 1 b a c k g r o u n d c a 1 o r 

platted 

1 0 foreground color 

platted 

1 1 foreground color 

plotted 


XOR Format 

f g bit b g bit ac t i on 

0 0 transparent to 

screen 

0 1 background color 

pi at ted 

1 0 xar screen 

1 1 foreground color 

plotted 

ds.w i background color (color table 

i rid ex ) 

dSn w 1 foreground color (color table 

i ndex ) 

ds. w 32 interleaved background/f oreground 

i mage. 

(word 0 = b a c k g r a u n d line 0 „ 
word 1 - foreground line 0. 
w o r d 2 b a c k g r ound line 1 . 

word 3 - foreground line 1. 





L.i ne 
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etc, ) 


output; clabbers a&. ("C" programmers beware.) 

bu 9 ss This function is not usable as a LIME "A" call 

in the 1st release of IDS,. See Example 
Program #2 below for the technique one must 
adopt to use this function. 


(14) Copy raster form 


dc.w *AooE ; Copy a raster form from source to 

destination. 


input: See the VDI discussion of Copy Raster , Opaque 

& Transparent, EXCEEPT, CONTRL (0), CONTRL (1 ) , 
CONTRL (3) , and C0NTRL<6> are ignored. 

CQPYTRAN - Opaque/Transparent mode flag. (0 ~> 
Opaque) 

output: none. 

n °te: See the BitBlt discussion above. 


USING THE LINE "A" INTERFACE 


The inputs to the LINE "A" routines are contained in a 
structure pointed to by the value returned in aO after an 
initialization call ($A000> has been made. This initialization 
only needs to be done once and any returned values can be saved 
and used as needed. 

The LINE "A" interface can be used in cooperation with the VDI 
and AES, however, one cannot expect the variables below to be 
unchanged after the VDI or AES has been used. Therefore, if an 
application wants to mix calls to LINE "A" and VDI/AES, it must 
reload any variables that it uses as input to the LINE "A" 
routines. 

The caller should assume that registers d0~d2 and a0-a2 are 
clobbered upon return. The rest are preserved. 


The LINE"A" input variables structure: 


offset. name 


type description 
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0 

VPLANES 

war d 

number o-f video planes. 



VWRAP 

war d 

number of bytes/video 


. i n© 

*1 





note: 

These var i ab 1 es 

can be changed to implement 




s p ©c i a ]. e*f f ec t s 

- , e . g . , doub 1 i ng VWRAP will 




cause the routines to skip 1 scanline between 



every scan 1 i ne 

t h at is output to t h e s c r & e n 

II 



Of course , any 

mo d i f i c a t i o n s made t o t h ese 




var i abl es mu si: 

b © Lt n d o n e w h en no r rn a 1 




operation of the LINE! "A" (or VDI) is 




desired . 



4 

CONTRL 

1 ong 

ptr to the CONTRL array 


8 

INTIN 

3. ong 

ptr to the INTIN array. 


12 

PTSIN 

1 ong 

ptr to the PTSIN array. 


16 

INTOUT 

1 ong 

ptr to the INTOUT array 

M 

20 

PTSOUT 

1 ong 

ptr to the PTSOUT array, 



note: 

See the GEM VDI 

manual for a discussion of the 



above arrays, 



24 

COLD I TO 

word 

current color bit-plane 
val ue. 

0 

26 

COLD I T 1 

word 

current color bit-plane 
value. 

1 

28 

C0LBIT2 

war d 

current color bit-plane 
val ue. 

o 

30 

COLD I T3 

word 

current color bit-plane 
val ue. 



note: current 

•foreground writing color = 1*C0LBIT0 + 





2*C0LBIT1 + 
4*C0LBIT2 + 
8*C0LBIT3. 




LSTLIN 

word 

sot this to -- 1 

i t V 

and forget 

34 

LNMASK 

word 

equi valent to 
style- 

VDI ' s 1 i ne 

36 

WMODE 

word 

wri ting made, 
repl ace mode, 

(0 -> 




1 « > 

transparent 


mode , 

2 ~> xor mode, 

3 => inverse 
trans mode. ) 



note: 

see VDI manual 

■for di 

scussion of writing modes. 

38 

XI 

word 

1 

coordinate. 

40 

Y 1 

word 

yi 

coordi nate. 

42 

X2 

word 

x 2 

coordinate. 


7S& 
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44 Y2 
46 FATPTR 

50 FATMSK 
52 MF ILL- 


54 CL IF' 

56 XliINCL 
58 YMINCL 
60 X MAX CL 
62 YMAXCL 


64 XDDA 


n otes 


66 DDAINC 


n ate; 


60 SCALD I R 
70 MONO 


72 SOURCE X 
74 BO URGE Y 


notes 


w a r d y 2 c o o r d i. n a t e „ 

1 a n g p t r t o t h e c u r r e n t f i ]. 1 

pat tern - 

w a r d f i 1 1. p a 1 1 e r • n "mask". 

w □ r d ni u 1 1 i p 3. a n e f i 1 1 f I a g « 

< 0 > c u r r e n t f i 1 1 p a 1 1 a r n j. s s i n g I a 

p lane) 

(1 -> current fill pattern is multi- 
plane) 

w o r cl 3. i p p i n g f 1 a g ( 0 - > n a c: 1 i p p i n g ) 

word minimum j< clipping value, 

w o r d m :i. n i m u m y c 1 i p p i n g v a I u © - 

w o r d m a x i m u rn x c lip p i n g v a 1 u e - 

w o r d m a x i m u m y c 1 i p p i n g v a 1 u e » 

w o r d a c c u m u 1 a t o r f a r t e x t b 1 1 x d d a ■ 

S h a u ]. d b © i n i t © d t o 0 0 0 0 H < - 5 ) b e f a r e © a c h 

i nvacat i on of T ex t B 1 1 * 


word fractional amount to scale 

up or down „ 

If scaling up, set DDAINC to 256* ( Intended 
si za Actual si za) /Actual si zb. 


If scaling down, set DDAINC to 256* < Intended 
s i z b ) / Ac t ua :L i z a „ 


word scale dir ec t ion f 1 ag - ( 0 

Ks > down ) 

word 0 => current font is not 

m o n o 3 p a c: e d 0 E i t s 0 K f o r 
t h i c k e n i n g t a i n c r e a s e 
t h a w i d t h o f t h © c u r r e n t 
f on t . 

1 - > curr © n t f o n t is 
monospaced AND thickeni ng 
may not increase the width 
of the font * 


word x coord of character in 

font form, 

word y coord of character in 

font farm. 

SOUECEX can be computed from the information 
held in the font header. (see Appendix G of 
VDX manual for header def ) 
e , g . 

t © m p I" c:: h a r a c: t © r v a 1 u e ; 

t © m p »» f n t ..... p t r - > firs t _ a d e ; 

S 0 L J E C E X - f n t _ p t r - > o f f t a b i © < t © m p ) ; 


7*7 


L i n @ 
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of font form) 


76 

78 

80 

82 


84 

88 


90 


97 
94 
96 

98 

1 00 


SOURCE Y is typically set to 0. 


1 i ne 


DESTX 

DESTY 

DELX 

DELY 



war d 

x coord of 
screen - 

c haracter 


war" d 

y coord of 
sc reen « 

c haracter 

war d 

wi dth a i 

charac ter « 


war d 

he:i. ght of 

character 



note; 


DEILX ?•< DELY can be computed from the font 
header . 


@ ■ 9 • t emp “ c h ar ac t er value; 

temp = f nt._pt.r-- >f i r st....ade ; 

SOURCE X f nt_ptr- >of f _.tab 1 e ( temp ) ; 

D E L X * f n t p t r - > o f f t a b i e ( t e m p + 1 ) ■••• S 0 U R C E X ; 
DELY -- f n t _ p t r — > f o r m ... h e i g h t ; 


FBASE 

FWIDTH 


long ptr to start of font data, 

(font form) 

word width of font form. 


note: 


e . g . 


STYLE 


notes 


LITEMASK 

SKEWMASK 

WEIGHT 

R0FF 

L.0FF 


notes 


e . g . 


FBASE ?s. FWIDTH can be computed from the -font 
header . 

FBASE! « f nt_ptr~>dat„tabl e; 

F W I DTH — f n t __p t r -- >f or m _ w i d t h ; 

word vector of TextBlt special 

e f f e c t. s flags. 

B i t. 0 Thicken flag. 

Bit 1 ~ Lighten flag. 

Bit 2 = Skewing flag. 

Bit 3 = Underline flag. 

( i g noread ) 

Bit 4 = Outline flag. 

Set the bits to select the desired effects. 
Underlining must be done by the application. 

word the mask to use in lightening text, 

word the mask to use in skewing text, 

word the width by which to thicken text, 

word offset above character baseline when 

skewing. 

word offset below character baseline when 

skewing . 


The above 5 input variables can be computed 
from the font header. 

LITEMASK = f nt_ptr-->l i ghten ; 

S K E W M A S K = f n t .... p t r - > skew; 

WE-' I GHT f n t _p t r > t hi i c k en ; 

if (skewing) -C 

F( 0 F F ™ f n t ... p t r > r i g h t ... o f f set; 
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LGF'F 


1 02 
104 


1 06 
1 OB 
1 1 2 


114 

116 


118 


f n t. p t r > ]. a f t a *f f s a t u 

0 3. s® { 

RGFF ~ On 
LGFF =::: 0 || 


scale: 

CM UP 


w □ r c:l s c a 1 i n g f 1 a g « ( 0 -••• > n o s c a 1 i n g « ) 

w or d c h a r a c t e r r a t a t ion v e c t o r - 

0 > n o r mal h o r i z o n t a 1 a r i e n t a t: i o n 

900 ::; => rotated 90 degrees 
c: 3. oc kwi se, 

:L 8 0 0 - > r o t a t e d 1 8 0 d e g r e e s 
cl oc kwi 38 u 

2700 »> rotated 270 degrees 
clock wise* 


TEXTFG 

wor d 

text f 

SCRTCHP 

3. ong 

p t r t o 



b uf far 

BCRPT2 

wor d 

of f set 



b uf f er 


a r egro u n d c o 3. a r * 
start of text, special effects 
of sc a 1 i n g h uf f er in above 


n o t © s T h e s e s p e c i a 1. of fee t s b u f f e r p o i n t er s m u s t b e 

i n i t .i a 1 i z © d ta e f o r e Tex *1: Bit e f f e c t s c a n b e 
used „ 


TEXTBB word 

C0PYTRAN word 


text background color* (4/20/05) 
RAMVDI oniy* 

c o p y r a s t e r f o r fin t y p e f 1 a g « 

(4/26/85) RAMVDI * 

0 -> Opaque type 

n plane source > n plane 

dost 

BitBlt writing modes 
^ 0 > 7 r a n s p a r e n t type 

1 “'■plane source > rv-plane 

dost VDI writing modes 


8EEDABGRT long ptr to routine which is called 

within the seedfill logic to allow 
the fill to be aborted* Initialized 
t a p o i n t toad ummy r out in© wh i c: h 
r e t u r n s F ALSE« Ret u r n i n g T R U E a b art s 
the seedf ill* 


notes This ptr doesn't exist in 1st release of T0S* 

See Example Program #2 for the technique to 
u s e t o i d e n t i f y t h e 1 s t T 0 8 re 3. e a s e * 
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* 

■X- 


E X A M F‘ L E L I N E 1 1 A 1 ' E Q U A T E S 


VPLANEB 


VWRAP 


CONTRL 


INTIN 


F’TSIM 


INTOUT 


PTSOUT 


COLB I TO 


COLB I T 1 


C0LBIT2 


C0L.BIT3 


LSTL I N 


LNMASK 


WliODE 


XI 

equ 

Y 1 

equ 

X2 

equ 

Y2 

equ 

PATPTR 


PATMSK 


MFILL 


CLIP 

eq u 

XMINCL 


YMINCL 


XMAXCL 


YMAXCL 


X DDA 

equ 

DDAINC 


SCALD IR 


MONO 

eq u 

SRCX 

eq u 

SRCY 

equ 

DSTX 

equ 

DSTY 

equ 

DELX 

equ 

DELY 

equ 

FBASE 


FWIDTH 


STYLE 


LITEMSK 


SKEWMSK 


WEIGHT 


ROF'F 

equ 

LOFF 

equ 

SCALE 


□HUP 

eq u 

T'EXTFG 


SCRTCHP 



L i n e 


eq u 
equ 
equ 
equ 
eq u 
eq u 
eq u 
equ 
eq u 
eq u 
equ 
equ 
equ 
eq u 


equ 

equ 

equ 

equ 
eq u 
equ 
equ 

eq u 
eq u 


eq u 
eq u 
equ 
eq u 
equ 
equ 


eq u 

eq u 
eq u 

A D o c:: u m e n t P A G E 


0 

4 

8 

12 

16 

20 

24 

26 

28 

30 

32 

34 

36 

38 

40 

42 

44 

46 

50 

52 

54 

56 

58 

60 

62 

64 

66 

68 

70 

72 

74 

76 

78 

80 

82 

84 

88 

90 

92 

94 

96 

98 

100 

1 02 

104 

106 

108 
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SCRPT2 

eq u 


1 1 2 

TEXTBB 

eq u 


1 1 4 

C 0 P Y T R AN equ 


1 1 6 


S E E D A B 0 R T e q u 


J. 1 8 



* 

I N I T 
PUTPIX 

eq u 

. equ 

T A 0 0 0 

I MI T+ 1 

BE TP IX 


eq u 


INIT+2 

ABLINE 


eq u 


INI T+3 

HABLINE 

RECTFILL 

eq u 

equ 

IN I T+5 

IN IT-)- 4 

POLYFILL 

BITBLT 

equ 

eq u 

I N I T+6 

INIT+7 

TEXTBLT 


eq u 


INIT+8 

SHOWCUR 


equ 


INIT+9 

HI DECOR 


eq u 


INIT+10 

CHOC UR 
DRSPRITE 

equ 

eq u 

INIT-h 12 

INIT+11 

UNSPRITE 

equ 


IN I T+13 


COPYRSTR 

equ 


IN I T+14 


SEEDFILL 

equ 


I NIT -i-l 5 



EXAMPLE 

PROBRAM ttl 




text 





start: dc.w 

INIT 



i ni ti al ize. 

move . w 

#-■1 ,1-STLIN <a0> 



once and for 




!i 

all. 

move - w 

#*5555,LNMASK<aO> 

; di thered 

1 i n e - 

move, w 

# 0 , WMODE (aO) 



repl ace mode. 

move , w 

#1 ,, COLB I T 0 ( aO ) 




move, w 

#1 ,C0LBIT1 <aO) 




move, w 

#1 , C0LBIT2 (aO) 




move, w 

# 0 , COLB I T3 (aO) 


H 

drawl nq col or 





“ 7. 

move, w 

#0, XI (aO) 

5 XI = 

* 0 . 


move, w 

# 0 , Y 1 (aO) 

5 Y1 = 

= 0 . 


move. w 

#99, X 2 (aO) 



X2 « 99, 

move, w 

#99, Y2 <aO) 



Y 2 ss 99 , 

d c: „ w 

ABLINE 



draw line. 


move « w 

#0 , ( sp ) 


trap 

# :i 

U ex i t . 


end 
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EXAMPLE PROGRAM #2 
tex t 


•* 


start : 

c: 1 r « 1 

(sp ) 




move h w 

##20, -- (sp) 




t r ap 

#1 


s u p e r v i s o r m o d © r e q u i r © d 




9 

to use line "A" 





i"' o u t i. n © s v 1 a . j s r . 


addq 

#6 , sp 




move. 1 

dO , s t k save 

3 

save old stack ptr« 





* F i n d 

* 

out whi c:h 

versi on of LINE 

"A" h 

andler exists. 


move. 1 

#0 , a2 

i» 

convenient value for 




? 

test i ng . 


dc . w 

INIT 

$ 

line “A" 




5 

i ni t. i al i sat i on . 


move. 1 

a 2 , d2 

? 

ol d version? 


b n © 

a2ok 

i» 

n o , a2 p o i n t s t o ar r ay 




* 

of 1 in© "A" routine 




!» 

ad d r esses . 


1 ea 

-4*15 (al) ,a2 

» 

!» 

yes , a2 i s untouched , so 


■* 

* 

* 

a2ok : 

* 

* 

■M* 


; use ai plus 
; d i sp 1 ac ©men t (15 
; addresses) . 

a 2 n o w p o i n t s t c:) a r r a y o f line " A 11 r o u t i n e a d d r esses. 

move-1 Ca2) , drawaddr ; fetch draw 

; r o u t i n e add r ess. 

Bug workaround/ Ini t i al i sat i on compl ate. 



move,, w 

#0 , dO 


; i n i t x . 


move. w 

#0 , d 1 


; i n i t y „ 


1 ea 

spr i te ,j aO 

; point to sprite. 


1 ea 

save , a 2 


; point to save area 

1 oop 3 


movem. w 

dO-dl , 

-“(sp) ; save x, y 


movem. 1 

a0/a2 , (sp ) 

; save ptrs. 


move,, 1 

a6 , ~ (sp ) 

$ draw 

cl obbers a6. 


tst . w 

ol d 1 i nea 

; ol d 

or new line "A" handler? 


b ©q 

new 


; new , branch . 


move. 1 

drawaddr , 

a3 

; fetch draw routine 
;; address. 


j sr 

( a 3 ) 


; draw the ol d way. 

•X 

b r a 

merge 



news 

•* 

d c « w 

DRSPRITE 


; draw the new way. 

merges 


move. 1 

( sp ) ■+■ , 

a 6 
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restore ptrs 


movem, 1 


wax t s 
* 

movem, I 
move, 1 
d c „ w 
move, 1 
movem, 1 
movem , w 
addq „ w 
cmp , w 
bl e 

* 

move, 1 
move, w 
trap 
addq 

* 

move. w 
trap 

data 

* 

* 

* 

sprites dc-w 

dc . w 

bobs dc. w 

d c: . w 
dc. w 
d c: , w 
dc. w 
d c:: » w 
dc „ w 
dc. w 
dc: . w 
d c: k w 
d c: « w 
dc: . w 
d c . w 
dc . w 
dc - w 
d c , w 
dc h w 
d c: , w 
dc. w 
d c: . w 
dc . w 
d c . w 
dc , w 
d c . w 


(sp ) "I- ,, a0/a2 
#2000 , d2 

dbra d 2, wait 

a » J / a 2 , •■■■ ( s p ) 
a 6 , ( s j::> ) 

UNSPRITE 
(sp ) ■+■ , a 6 
(sp ) -I- , a0/a2 

(sp ) -I- 4 dO d 1 

# 1 , d 0 
#640, dO 
]. oop 

stksave , (sp ) 

#$20 , — ( sp ) 

#1 

#6 , sp 

#0 , - ( sp ) 

#1 


0 , 0 

1 , 0,1 

$FFFF 
$07F0 
$FFFF 
$0f f 8 
$FFFF 
$ 1 f ec 
$FFFF 
$1804 
$FFFF 
$1804 
$FFFF 
$1004 
$FFFF 
$ 1 e3c 
$F FFF 
$1754 
$FFFF 
$ 1104 
$FFFF 
$0b28 
$FFFF 
$ 0 ddQ 
$FFFF 
$0628 


H wait a bit. 

H save ptrs, 

5 u n d r a w c 1 o b b e r s a 6 , 


; restore ptrs, 
; restore x,y„ 

; i n c x „ 


; user mode. 


; ex i t . 


S k ? y a f f s e t s o f h otspot . 
; format , background , 

; foreground « 

; b a c k g r o u n d line 0 » 

; for" e g r o u n d 1 i n e 0 „ 
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d c w 

TFFFF 

de « w 

$07d0 

d c w 

$FFFF 

d c .. w 

$2e 1 0 

d c h w 

$FFFF 

do * w 

$39 eO 

d c: h w 

TFFFF 

d c - w 

$3800 


b a s 


•* 


•* 


* 


st k saves 

d s h 1 

save; 

d s - b 

□ I d ]. i nea ; 

ds . w 

dr a wad dr s 

ds* 1 


end 


1 

10+64 

1 

1 
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B 


.1 -cA 


BAG '0 TRICKS, 10 
BG COL. , 6 , 9 1 0 ,, 1 1 , 1 2 

BitBlt, 1, 5, 12, IS, 19, 21 


CHUR, 12, 19, 20 
CLIP , 4, 5, 17, 20 


COLB I TO, 3, 

4, 

5, 

16, 

9 A 

1,/ N 

21 

C0LBIT1 , 3, 

^ >) 


16, 

20, 

21 

C0LBIT2, 3, 

4, 

b; , 

1 6 , 

20, 


C0LBIT3, 3, 

4, 


16, 

20, 


CONTRL, 2, 

5, 

15, 

16, 

20 


Copy raster 

f or m , 

1, : 

1.5, 

19 

COPYTRAN , 1 

L5 , 

19, 

21 




D 


D FORM, 6, 8 
D NXLN , 6, 8 
D NXPL , 6, 8 
D NXWD, 6, 8 
D XMIN, 6, 8 
D YMIN , 6, 8 
DDAINC , 12, 17, 20 
DEL.X , 12, 18, 20 

DEI..Y, 12, 18, 20 
DESTX , 12, 18 
DESTY, 12, 18 
Draw sprite, 1, 14 


E 

EQUATES, 20 

EXAMPLE PROGRAM #1, 21 

EXAMPLE PROGRAM #2, 2, 15, 19, 22 


FBASE , 12, 18, 20 
FG COL, 6, 9, 10, 11, 12 
F i lied r ec t an g 1 e , 1 , 4 , 11 
FWIDTH, 12, 18, 20 


Get pixel, 1, 3 

H 

Hide mouse, 1, 13 

H o r i z o n t a 1 1 i n e , 1 , 4 


I ndex 


Page 1 




i. .. i n e - A R e i 0 r 0 n c # M a n u a 1 ]' n d e x 


I 


I n 1 1 i a 1 i 2 a t i a r ) , 1 , ;l. 5 , 2 2 


L 

Line, 1, 2, 3, 4, 5, 6, 7, 14,-15, 16, 18, -20, 21, 22, 23 

Li rte-by 1 i ne -f i 1 1 ed pol yqon , 1 , 5 

LITEMASK, 12, 18 
LNMASK , 3, 4, 16, 20, 21 

LOFF, 12, IS, 19, 20 


M 


MEMORY FORMS, 8 
MFILL, 4, 5, 17, 20 
MONO, 12, 17, 20 

0 

OP TAB, 6, 7, 9, 10, 11, 12 

P 

P A DDR , 6, 9 
P BLOCK LEM 
P MASK, 6, 10 

P NXL..N, 6, 9, 10 

P NX PL, 6, 10 

PARAMETER BLOCK, 6, 7 
PATMSK , 4, 5, 17, 20 

PATPTR, 4, 5, 17, 20 

PATTERNS ,1,9 
PLANE CT, 6, 8 
PTSIN, 2, 3, 5, 16, 20 
Put pixel, 1, 2 


R 


RASTER OPERATIONS, 9 
ROFF, 12, 18, 19, 20 


S FORM, 

6, 

8, 

11, 13 

S IMXLN , 

6, 

8, 

1 1 

S NX PL, 

6, 

8, 

10, 11 

8 NXWD, 


8, 

1 1 

S XMIN, 

6, 

8, 

1 1 

S YMIN, 

6, 

8, 

1 1 

SCALD IR, 

1 

o 
y„. v 

17, 20 

SCALE , 1 

'“•k 
^ ') 

17 

, 19, 2' 

SCRPT2 , 


, 19, 21 
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in to ■ - 1 R e f i - <o r ; P a n u a 1 1 n d e 


SCRTCHP , 

1 2 , 1 9 , 

20 

SEED ABORT 

, 19, 21 


Seedf i 1 3 , 

1 , 1 9 , 

7 '! 

Show mans 

b , :f. ,, i :::: 


5KEWMASK v 

12, 18 


SOURCE!.' X , 

1 2 , 1 7 , 

:L a 

SOURCE Y , 

12, 17, 

1 8 

start , 6 , 

8, 12, 

IS, I 9 , 

st ksave , 


24 

STYLE, 3, 

12, 1 6 , 

I 8, 20 

TEX TBS, 1 

2, 19, 2 

71. 

Text Bit , 

1, 12, 1 

7, 18, 

TEXTFB, 1 

2, 19, 2 

:o 

YDS , 1, 2 

•I r~. '1 c:: 

ij J. vU y J. t 

> 

T ran sf arm 

mouse ■ 

1, 13 


Undraw sprite, 1, 13 


VDI, 1, 2, 4, 7, 8, 12, 13, 14, 15, 16, 17, 19 

W 


WEIGHT, 12, 18, 20 
WMODE, 3, 4, 5, 12, 


16, 20, 21 


XDDA , 12, 17, 20 
X MAX CL, 5, 17, 20 
XMIMCL, 4, 5, 17, 20 


YMAXCL , 5, 17, 20 
YM I NCI... , S, 17, 20 
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